GET-Parameter
Die sog. GET-Parameter können nach einem “?” an die URL angehängt werden, um Felder in der Suche voreinzustellen oder einen Deeplink für ein Angebot zu erstellen.
Dies geschieht nach folgendem Muster:
https://basisurl?parameter1=wert¶meter2=wert,wert
Ist es möglich für einen Parameter mehrere Werte anzugeben so sind diese kommasepariert anzugeben.
Parameter für die mehrere Werte übergeben werden können sind in der Dokumentation mit *
markiert.
Zudem können mehrere Parameter gleichzeitig übergeben werden. Diese werden mit einem “&” verknüpft. Die Reihenfolge spielt hierbei keine Rolle.
Beispiel:
https://partner-app.tbe2.io/index.html#/search?pid=A-00000-0&cntry=1030
Folgende Voreinstellungen sind möglich:
- Kategorie - ‘ngn’
- Partner-ID - ‘pid’
- Sprache - ‘lang’
- Land - ‘cntry’
- Region - ‘rgn’
- Stadt - ‘cty’
- Währung - ‘cur’
- Hotel-ID - ‘htl’
- Hotelname - ‘htln’
- Veranstalter-Hotel-Code - ‘htlc’
- GIATA-Code - ‘giata’
- IFF-Code - ‘iff’
- Früheste Hinreise - ‘ddate’
- Späteste Rückreise - ‘rdate’
- Dauer - ‘dur’
- Zusatzwünsche - ‘add’
- Hotelattribute - ‘attr’
- Anzahl Reisender / Kinder - ‘trvlr’
- Zimmer - ‘room’
- Verpflegung - ‘meal’
- Veranstalter - ‘prtr’
- Preis - ‘price’
- Abflughafen - ‘dep’
- Hotelkategorie - ‘cat’
- Hotelbewertung - ‘rtng’
- Anzahl der Bewertungen - ‘rtnga’
- Weiterempfehlung - ‘rcmnd’
Engine - ngn
Ermöglicht eine gezielte Suche nach Angeboten aus einer der unten genannten Kategorien.
Datentyp: Zeichenkette
Voreingestellter Wert: package
Mögliche Werte:
- ‘package’ - Pauschalreisen
- ‘flight’ - Flüge
- ‘hotel’ - Hotels
Partner-ID - pid
Hierüber werden getätigte Buchungen Ihrem Account zugeordnet.
Geben Sie Ihre Partner-ID immer mit an!
Datentyp: Zeichenkette
Beispielwert: A-00000-0
Sie finden ihre Partner-/Account-ID in unserem Partnerbereich unter:
“Meine Übersicht” > “Partnerdaten” > “Accounts” > “Account-ID”
Sprache - lang
Stellt die IBE in der angegebenen Sprache dar.
Datentyp: Zeichenkette
Voreingestellter Wert: de
Mögliche Werte:
- ‘de’ - deutsch
- ‘en’ - englisch
- ‘dn’ - dänisch
- ‘cs’ - tschechisch
HINWEIS: Um die Darstellung des Sprachparameters in der URL zu vermeiden, empfehlen wir die Einbindung per HTML-Tag z. B. param-lang=”en”.
Land - cntry
Zeigt Suchergebnisse für das angegebene Land an.
Datentyp: Zeichenkette
Beispielwert: 1030
Mögliche Werte:
Region - rgn
Zeigt Suchergebnisse für die angegebene Region an.
Datentyp: Zeichenkette
Beispielwert: 1329
Mögliche Werte:
Stadt - cty
Zeigt Suchergebnisse für die angegebene Stadt an.
Datentyp: Zeichenkette
Beispielwert: 10848
Mögliche Werte:
- HIER KLICKEN
In der URL eine Region ‘rgn’ übergeben, um alle für diese Region verfügbaren Städte zu erhalten.
Die Bezeichnung ist zwischen den <title>-tags zu finden. Zwischen den <value>-tags ist der für den Parameter zu verwendende Wert.
Währung - cur
Zeigt Preise in der angegebenen Währung an.
Datentyp: Zeichenkette
Voreingestellter Wert: EUR
Mögliche Werte:
- ‘EUR’ - Euro
- ‘CZK’ - Tschechische Kronen
- ‘DKK’ - Dänische Kronen
- ‘GBP’ - Britische Pfund Sterling
- ‘CHF’ - Schweizer Franken
Dieser Parameter ist unabhängig von der voreingestellten Sprache.
Hotel-ID - htl
Zeigt Angebote für das Hotel mit der angegebenen Hotel-ID an.
Diese Methode der Hotelvorauswahl ist zu bevorzugen.
Datentyp: Zeichenkette
Beispielwert: 12786
Mögliche Werte:
- HIER KLICKEN und Hotelnamen in die Suche eingeben
- Passendes Hotel aus den Vorschlägen auswählen
- “Reise finden”
- Anschließend in der URL nach ‘htl=’ suchen
Hotelname - htln
Zeigt Suchergebnisse für den angegebenen Hotelnamen an.
Datentyp: Zeichenkette
Beispielwert: Hilton
Veranstalter-Hotel-Code - htlc
Zeigt Suchergebnisse für den angegebenen Hotel-Code an. Sollte immer in Verbindung mit prtr verwendet werden.
Datentyp: Zeichenkette
Beispielwert: RMF828
GIATA-Code - giata
Zeigt Suchergebnisse für die angegebene GIATA-ID an.
Datentyp: Nummer
Beispielwert: 1030
IFF-Code - iff
Zeigt Suchergebnisse für den angegebenen IFF-Code an.
Datentyp: Nummer
Beispielwert: 3
Früheste Hinreise - ddate
Zeigt Suchergebnisse für das angegebene früheste Hinreisedatum an.
Datentyp: Zeichenkette
Voreingestellter Wert: siehe Dauer - ‘dur’
Beispielwert: 2018-09-10
Kann im Format Jahr-Monat-Tag oder mit einer relativen Anzahl von Tagen in der Zukunft angegeben werden.
Muss in Kombination mit dem spätesten Rückreisedatum angegeben werden, ansonsten wird eine Dauer zwischen 7-21 Tagen eingestellt.
Späteste Rückreise - rdate
Zeigt Suchergebnisse für das angegebene früheste Rückreisedatum an.
Datentyp: Zeichenkette
Voreingestellter Wert: siehe Dauer - ‘dur’
Beispielwert: 2018-09-10
Dies kann im Format Jahr-Monat-Tag oder mit einer relativen Anzahl von Tagen in der Zukunft angegeben werden. Muss in Kombination mit dem frühesten Hinreisesedatum angegeben werden, ansonsten wird eine Dauer zwischen 7-21 Tagen eingestellt.
Dauer - dur
Zeigt Suchergebnisse für die angegebene Dauer an.
Datentyp: Zeichenkette
Voreingestellter Wert: 7-21 Tage
Mögliche Werte:
- ‘exact’ - Differenz zwischen frühester Hinreise und spätester Rückreise
- Eine Zahl - Angegebene Anzahl an Tagen wird als Mindestreisedauer festgelegt
- Zwei Zahlen, kommasepariert - Mindestdauer und Maximaldauer
Zusatzwünsche - add
*
Zeigt Suchergebnisse für die angegebenen Zusatzwünsche an.
Datentyp: Kommaseparierte Liste aus Zeichenketten
Voreingestellter Wert: 0 - ‘beliebig’ in allen Kategorien
Beispielwert: -1,3
Mögliche Werte:
- ‘0’ - Beliebig
- ‘1’ - Transfer
- ‘2’ - Meerblick
- ‘3’ - Kinderfreundlich
- ‘4’ - Skipass
Angebote ohne Transfer und Kinderfreundlich.
Es können mehrere Werte kommasepariert übergeben werden.
Ein ‘-‘ vor dem Wert negiert die Angabe.
Hotelattribute - attr
*
Zeigt Suchergebnisse für die angegebenen Hotelattribute an.
Datentyp: Kommaseparierte Liste aus Zeichenketten
Mögliche Werte: HIER
Title entspricht dem ensprechenden Hotelattribut und value dem für das Attribut zu übergebenden Wert.
Es können mehrere Werte kommasepariert angegeben werden.
Anzahl Reisender / Kinder - trvlr
*
Zeigt Suchergebnisse für die angegebene Anzahl an Reisenden an.
Datentyp: kommaseparierte Liste aus Nummern
Voreingestellter Wert: 2
Beispielwert: 2,7,10
2 Erwachsene mit zwei Kindern Alter 7 und 10
Die erste Zahl gibt die Anzahl der reisenden Erwachsenen an.
Jede weitere Zahl gibt das Alter eines mitreisenden Kindes an.
Zimmer - room
Zeigt Suchergebnisse für den angegebenen Zimmertyp an.
Datentyp: Zeichenkette
Mögliche Werte: HIER
Title entspricht dem ensprechenden Zimmertyp und value dem für das Zimmer zu übergebenden Wert.
Verpflegung - meal
Zeigt Suchergebnisse mit der angegebenen Verpflegung an.
Datentyp: Zeichenkette
Mögliche Werte: HIER
Title entspricht der ensprechenden Verpflegungsart und value dem für die Verpflegung zu übergebenden Wert.
Veranstalter - prtr
Zeigt Suchergebnisse für den angegebenen Veranstalter an.
Datentyp: Kommaseparierte Liste aus Zeichenketten
Mögliche Werte: HIER
Es können mehrere Werte kommasepariert angegeben werden. Die möglichen Werte sind abhängig von dem übergebenen Parameter bei “ngn”.
Preis - price
Zeigt Suchergebnisse für den angegebenen Maximalpreis oder der Preisspanne an.
Datentyp: Kommaseparierte Liste aus Zeichenketten
Mögliche Werte:
- Eine Zahl - Maximalpreis
- Zwei Zahlen, kommasepariert - Minmalpreis,Maximalpreis
Beispielwert: 100,500
Abflughafen - dep
*
Zeigt Suchergebnisse für den angegebenen Abflughafen an.
Datentyp: Kommaseparierte Liste aus Zeichenketten
Mögliche Werte: HIER
Es können mehrere Werte kommasepariert angegeben werden.
Hotelklassifikation - cat
Zeigt Suchergebnisse für die angegebene Hotelklassifikation an.
Datentyp: Nummer
Mögliche Werte: Zahlen von 0 - 6
‘0’ ist hierbei ‘beliebig’.
Hotelbewertung - rtng
Zeigt Suchergebnisse für die angegebene Mindesthotelbewertung an.
Datentyp: Nummer
Mögliche Werte: Zahlen von 0 - 6
‘0’ ist hierbei ‘beliebig’.
Hotelbewertungsanzahl - rtnga
Zeigt Suchergebnisse für die angegebene Mindesthotelbewertungsanzahl an.
Datentyp: Nummer
Beispielwert: 100
Weiterempfehlung - rcmnd
Zeigt Suchergebnisse für die angegebene Mindestweiterempfehlung an.
Datentyp: Nummer
Beispielwert: Zahlen von 0 - 6
‘0’ ist hierbei ‘beliebig’.